Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Resources

The Tab Information Resource

NEW WITH THE APPEARANCE MANAGER

You can use a tab information resource to specify the icon suite ID and name of each tab in a tab control. A tab information resource is a resource of type 'tab#'. All tab information resources must have resource ID numbers greater than 127. The Control Manager uses the information you specify to provide additional information to the corresponding tab control. Figure 2-3 shows the structure of this resource.

Figure 2-3 Structure of a compiled tab information ('tab#') resource

A compiled version of a tab information resource contains the following elements:

• Version number. An integer specifying the version of the resource.
• An integer that specifies the number of entries in the resource (that is, the number of tab information structures).
• A series of tab information structures, each of which consists of a 2-byte icon suite identifier and a variable-length string indicating the tab name.

Figure 2-4 shows the format of a compiled entry in a 'tab#' resource. A tab information entry specifies the icon suite ID and the name of a tab control.

Figure 2-4 Structure of a tab information entry

Each entry in a 'tab#' resource contains the following:

• Icon suite ID. A value of 0 indicates no icon.
• Tab name. The title of the tab control.
• Reserved. Set to 0.
• Reserved. Set to 0.